package com.mapper;

import com.bean.User;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface UserMapper {
    /**
     * 根据用户 ID 查询用户信息
     * @param id 用户 ID
     * @return 用户对象
     */
    User getUserById(Integer id);

    /**
     * 根据用户名查询用户信息
     * @param username 用户名
     * @return 用户对象
     */
    User getUserByUsername(String username);

    /**
     * 查询所有用户信息
     * @return 用户列表
     */
    List<User> getAllUsers();

    /**
     * 根据用户名和密码查询用户信息，用于登录验证
     * @param username 用户名
     * @param password 密码
     * @return 用户对象
     */
    User getUserByUsernameAndPassword(String username, String password);

    /**
     * 插入新用户，用于注册
     * @param user 用户对象
     * @return 受影响的行数
     */
    int insertUser(User user);

    /**
     * 根据用户 ID 更新用户信息
     * @param user 用户对象
     * @return 受影响的行数
     */
    int updateUser(User user);

    /**
     * 根据用户 ID 删除用户信息
     * @param id 用户 ID
     * @return 受影响的行数
     */
    int deleteUserById(Integer id);

    /**
     * 模糊查询用户信息并分页
     * @param keyword 模糊查询关键字
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 用户列表
     */
    List<User> getUsersByKeyword(String keyword, int offset, int limit);

    /**
     * 统计模糊查询的用户数量
     * @param keyword 模糊查询关键字
     * @return 用户数量
     */
    int getCountByKeyword(String keyword);
}